Favicon

You are here: Home > API Reference > UEM > MDM Devices > Retrieve OS version distribution statistics

Retrieve OS version distribution statistics

Required Permission: mdm.global.device.list

Retrieves aggregated operating system version distribution across managed fleet with device counts per version, essential for update planning and security compliance auditing.

GET
https://api.applivery.io/v1/organizations/{organizationId}/mdm/devices/os-versions 
curl -X GET "https://api.applivery.io/v1/organizations/{organizationId}/mdm/devices/os-versions" \
  -H "Authorization: Bearer <YOUR_API_KEY>"
const response = await fetch("https://api.applivery.io/v1/organizations/{organizationId}/mdm/devices/os-versions", {
  method: "GET",
  headers: {
    Authorization: "Bearer <YOUR_API_KEY>",
  },
});

const data = await response.json();
import requests

response = requests.get(
    "https://api.applivery.io/v1/organizations/{organizationId}/mdm/devices/os-versions",
    headers={"Authorization": "Bearer <YOUR_API_KEY>"},
)

data = response.json()

Request

Send your API key in the request header authorization
Example: Authorization: Bearer <token>

organizationId string
required
Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$

os string
optional
Operating system platform filter or identifier for platform-specific queries and version statistics.
androidiosmacoswindowsaosp

Responses

200 Response application/json
status boolean optional
data object optional
items array [object] optional
value string optional
Filter parameter for operating system version enabling version-specific device targeting for updates.
≤ 256 characters
os string optional
Operating system platform filter or identifier for platform-specific queries and version statistics.
android ios macos windows aosp
count integer optional
Number of devices running specific OS version for distribution analysis and upgrade planning.
≥ 0
{
    "status": true,
    "data": {
        "items": [
            {
                "value": "17.3.1",
                "os": "ios",
                "count": 47
            }
        ]
    }
}
401 Response application/json
status boolean optional
false
error object optional
code number optional
4001
message string optional
Unauthorized
{
    "status": false,
    "error": {
        "code": 4002,
        "message": "No auth token"
    }
}
404 Response application/json
status boolean optional
false
error object optional
code number optional
3001
message string optional
Entity not found
{
    "status": false,
    "error": {
        "code": 3001,
        "message": "Entity not found"
    }
}